home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / source.lha / Geomview / INSTALL < prev    next >
Encoding:
Text File  |  1993-11-17  |  4.0 KB  |  83 lines
  1.  
  2. NOTE: This file is autogenerated from the Geomview manual.
  3.   For references to things not in this file, see the manual.
  4.   The manual is distributed in the "doc" subdirectory.
  5.  
  6.  
  7. Compiling and Installing the Source Code Distribution
  8. =====================================================
  9.  
  10. The main reason to get the source code distribution is to look at and/or
  11. work with the source code.  If you are only concered with *using*
  12. Geomview it is better to get the binary distribution.  It takes anywhere
  13. from 15 minutes to 1.5 hours to compile the entire source distribution,
  14. depending on what kind of computer you have.
  15.  
  16. Let `$GEOMROOT' denote the full pathname of the Geomview source
  17. code directory; this is the directory called `Geomview' that is
  18. created when you unpack the distribution.  This directory contains the
  19. Geomview source code as well as various other files and subdirectories
  20. that Geomview needs when it runs.
  21.  
  22. Before doing any compilation you should edit the file
  23. `$GEOMROOT/makefiles/mk.site.default'.  This file defines some
  24. `make' variables which specify your local configuration.  This
  25. includes the pathnames of the directories into which Geomview will be
  26. installed, and possibly some other settings as well.  There are comments
  27. in the file telling you what to do.  This file is included by every
  28. Makefile in the source tree, so the settings you specify here are used
  29. throughout the source.
  30.  
  31. If you will be compiling for both SGI and NeXT, you can do both in the
  32. same directory tree.  By default the Makefiles are set up to put the
  33. objects files, libraries, and executables in directories which depend on
  34. the type of computer, so the two architectures will not interfere with
  35. each other.  The Makefiles use a variable called `CPU' to determine
  36. the type of machine. Before doing any compilation you must arrange for
  37. this variable to have a value.  There are two ways you can do this.
  38.  
  39.  
  40.   1. If you will always be compiling Geomview on the same type of computer
  41.      (SGI or NeXT), edit the file `$GEOMROOT/makefiles/Makedefs.global'
  42.      to set the `CPU' variable to either `iris4' or `NeXT'.
  43.      The comments near the top of that file will tell you where to do this.
  44.  
  45.   2. If you will be compiling on both types of computers you can set a shell
  46.      environment variable named `CPU' to either `iris4' or
  47.      `NeXT', and the Makefiles will inherit the value from the
  48.      environment.  The script `$GEOMROOT/config' determines which kind
  49.      of computer you are on and sets this variable accordingly.  To use this
  50.      script, type `source config' in the (assuming a C-shell type shell)
  51.      in the `$GEOMROOT' directory shell in which you plan to do the
  52.      compilation.  Or you can set the variable directly; it should be either
  53.      `NeXT' or `iris4'.  You will need to do this in every shell in
  54.      which you plan to do compilation.
  55.  
  56.      Alternately, you could modify your shell initialization file
  57.      (`.cshrc' or whatever) to set `CPU' appropriately.
  58.  
  59.  
  60. Note that many of the Makefiles refer to a variable called `MACHTYPE'
  61. to determine the type of machine.  This is set to either `sgi' or
  62. `next', depending on the value of `CPU'.
  63.  
  64. Once you have configured your source tree by editing the files as
  65. described above and setting the `CPU' variable, you can compile and
  66. install Geomview by typing `make install' in the `$GEOMROOT'
  67. directory.  You can also type `make all', or equivalently just
  68. `make', to compile without installing, and then type `make
  69. install' later to install.
  70.  
  71. You can use these same `make' comands in any subdirectory in the
  72. tree to recompile and/or install a part of Geomview or a module.
  73.  
  74. If you want to compile fat binaries under NeXTStep 3.1, before doing any
  75. compilation edit the file `$GEOMROOT/makefiles/mk.next' to
  76. uncomment a particular line there.  There are comments in the file
  77. telling you which line to uncomment.
  78.  
  79. If you want to modify the complier flags used during compilation, edit
  80. the file `$GEOMROOT/makefiles/Makedefs.global'; the `COPTS'
  81. variable specifies the flags passed to the C compiler (cc).
  82.  
  83.